<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Building a small memory footprint library</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Berkeley DB Installation and Build Guide" />
    <link rel="up" href="build_unix.html" title="Chapter 7.  Building Berkeley DB for UNIX/POSIX" />
    <link rel="prev" href="build_unix_sql.html" title="Configuring the SQL Interface" />
    <link rel="next" href="build_unix_flags.html" title="Changing compile or load options" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 11.2.5.3</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Building a small memory footprint library</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="build_unix_sql.html">Prev</a> </td>
          <th width="60%" align="center">Chapter 7. 
		Building Berkeley DB for UNIX/POSIX
        </th>
          <td width="20%" align="right"> <a accesskey="n" href="build_unix_flags.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both"><a id="build_unix_small"></a>Building a small memory footprint library</h2>
          </div>
        </div>
      </div>
      <p>
        There are a set of configuration options to assist you in building
        a small memory footprint library.  These configuration options turn
        off specific functionality in the Berkeley DB library, reducing the
        code size.  These configuration options include:
    </p>
      <div class="variablelist">
        <dl>
          <dt>
            <span class="term">
              <code class="literal">--enable-smallbuild</code>
            </span>
          </dt>
          <dd>
            <p>
                    Equivalent to individually specifying all of the following
                    configuration options.  In addition, when compiling
                    building with the GNU gcc compiler, this option uses the
                    <code class="literal">-Os</code> compiler build flag instead of the
                    default <code class="literal">-O3</code>.
                </p>
            <div class="variablelist">
              <dl>
                <dt>
                  <span class="term">
                    <code class="literal">--with-cryptography=no</code>
                  </span>
                </dt>
                <dd>
                            Builds Berkeley DB without support for cryptography.
                        </dd>
                <dt>
                  <span class="term">
                    <code class="literal">--disable-hash</code>
                  </span>
                </dt>
                <dd>
                            Builds Berkeley DB without support for the Hash access
                            method.
                        </dd>
                <dt>
                  <span class="term">
                    <code class="literal">--disable-heap</code>
                  </span>
                </dt>
                <dd>
                            Builds Berkeley DB without support for the
                            Heap access method.
                        </dd>
                <dt>
                  <span class="term">
                    <code class="literal">--disable-queue</code>
                  </span>
                </dt>
                <dd>
                            Builds Berkeley DB without support for the Queue access
                            method.
                        </dd>
                <dt>
                  <span class="term">
                    <code class="literal">--disable-replication</code>
                  </span>
                </dt>
                <dd>
                            Builds Berkeley DB without support for the database
                            environment replication.
                        </dd>
                <dt>
                  <span class="term">
                    <code class="literal">--disable-statistics</code>
                  </span>
                </dt>
                <dd>
                            Builds Berkeley DB without support for the statistics
                            interfaces.
                        </dd>
                <dt>
                  <span class="term">
                    <code class="literal">--disable-verify</code>
                  </span>
                </dt>
                <dd>
                            Builds Berkeley DB without support for database
                            verification.
                        </dd>
                <dt>
                  <span class="term">
                    <code class="literal">--enable-stripped_messages</code>
                  </span>
                </dt>
                <dd>
                  <p>
                                Strips message text from the error messages issued by
                                Berkeley DB. This can reduce the size of the library by
                                roughly another 22KB.
                            </p>
                  <p>
                                If your library has stripped messages, you can get an idea of 
                                what text should be issued for a given error message by using 
                                the <a href="../articles/mssgtxt/index.html" class="olink">Message
                                    Reference for Stripped Libraries</a> guide.
                            </p>
                </dd>
              </dl>
            </div>
          </dd>
        </dl>
      </div>
      <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
        <h3 class="title">Note</h3>
        <p>
            <code class="literal">--disable-cryptography</code> and 
            <code class="literal">--enable-cryptography</code> are
            deprecated in the Berkeley DB 11gR2 release. 
            Use <code class="literal">--with-cryptography=no</code>
            and <code class="literal">--with-cryptography=yes</code>
            instead.
        </p>
      </div>
      <p>
        The following configuration options will increase the size of the
        Berkeley DB library dramatically and are only useful when debugging
        applications:
    </p>
      <div class="variablelist">
        <dl>
          <dt>
            <span class="term">
                <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug">--enable-debug</a>
            </span>
          </dt>
          <dd>Build Berkeley DB with symbols for debugging.</dd>
          <dt>
            <span class="term">
                <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug_rop">--enable-debug_rop</a>
            </span>
          </dt>
          <dd>Build Berkeley DB with read-operation logging.</dd>
          <dt>
            <span class="term">
                <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug_wop">--enable-debug_wop</a>
            </span>
          </dt>
          <dd>Build Berkeley DB with write-operation logging.</dd>
          <dt>
            <span class="term">
                <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-diagnostic">--enable-diagnostic</a>
            </span>
          </dt>
          <dd>Build Berkeley DB with run-time debugging checks.</dd>
        </dl>
      </div>
      <p>
        In addition, static libraries are usually smaller than shared
        libraries.  By default Berkeley DB will build both shared and
        static libraries.  To build only a static library, configure
        Berkeley DB with the
        <a class="xref" href="build_unix_conf.html" title="Configuring Berkeley DB">Configuring Berkeley DB</a> 
        option.
    </p>
      <p>
        The size of the Berkeley DB library varies depending on the
        compiler, machine architecture, and configuration options.  As an
        estimate, production Berkeley DB libraries built with GNU gcc
        version 4.X compilers have footprints in the range of 600KB to
        1.4MB on 32-bit x86 architectures, and in the range of 700KB to
        1.6MB on 64-bit x86 architectures.
    </p>
      <p>
        For assistance in further reducing the size of the Berkeley DB
        library, or in building small memory footprint libraries on other
        systems, please contact Berkeley DB support.
    </p>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="build_unix_sql.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="build_unix.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="build_unix_flags.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Configuring the SQL Interface </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Changing compile or load options</td>
        </tr>
      </table>
    </div>
  </body>
</html>
